home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / tools / other-tools / recase / recase.readme < prev    next >
Encoding:
Text File  |  1996-02-26  |  5.5 KB  |  164 lines
  1. Short:    Change case of file names (96.1)
  2. Uploader: i.einman@genie.com (Ian J. Einman)
  3. Author:   i.einman@genie.com (Ian J. Einman)
  4. Type:     util/cli
  5. Version:  96.1
  6.  
  7. Recase is a shell command to change the case of a filename.  It has two major
  8. purposes:
  9.  
  10. 1. To rename a file with a different letter case; for example, if you wanted
  11.    to change the name of a file "newname" to "NewName", rather than needing:
  12.  
  13.    >> Rename newname NewName
  14.    
  15.    you can simply type:
  16.    
  17.    >> Recase NewName
  18.    
  19.    You may specify multiple filenames on the command line as well.
  20.    
  21. 2. To change filenames to all upper or lower case letters.  For example, I
  22.    download files from MS-DOS machines that are 8.3 filenames in all capital
  23.    letters, and after I download them, I convert them all to small letters
  24.    with:
  25.    
  26.    >> Recase MAIN:Downloads/#?.zip LOWER
  27.  
  28. ----------------------------------------------------------------------------
  29.    
  30. Template: FILE/M,UPPER/S,LOWER/S
  31.  
  32. FILE/M:
  33.  
  34. Recase may operate on multiple names or patterns.  Any standard AmigaDOS
  35. pattern will be accepted, but if you wish to recase a filename to a mixed
  36. case, you need to specify entire filenames.  Patterns are only useful with
  37. the UPPER and LOWER keywords.
  38.  
  39. UPPER/S:
  40.  
  41. Convert the filename to all uppercase.  You may specify any AmigaDOS patterns
  42. for this operation.  If you have Workbench 2.1 or above, this will respect
  43. international characters. (*)
  44.  
  45. LOWER/S:
  46.  
  47. Convert the filename to all lowercase.  You may specify any AmigaDOS patterns
  48. for this operation.  If you have Workbench 2.1 or above, this will respect
  49. international characters. (*)
  50.  
  51. (*) Of course, you are unlikely to encounter international characters in
  52.     filenames that originated under MS-DOS!
  53.     
  54. ----------------------------------------------------------------------------
  55.  
  56. Examples/Usage:
  57.  
  58. Here are some examples of how to use Recase.
  59.  
  60. >> dir
  61.    thesefilenames                  _areeasiertoread
  62.  
  63. Not really!  So let's fix it...
  64.  
  65. >> Recase TheseFileNames _AreEasierToRead
  66.  
  67. >> dir
  68.    TheseFileNames                  _AreEasierToRead
  69.  
  70. >> dir MAIN:Downloads
  71.    GM3208.JPG                      GM3209.JPG
  72.    GM3211.GIF                      GM3212.GIF
  73.    GM3219.GIF                      GM3224.GIF
  74.    
  75. Not how I like it, so I'll fix it...
  76.  
  77. >> Recase MAIN:Downloads/#? LOWER
  78. >> dir 
  79.    gm3208.jpg                      gm3209.jpg
  80.    gm3211.gif                      gm3212.gif
  81.    gm3219.gif                      gm3224.gif
  82.  
  83. Let's pretend we use MS-DOS (don't try this please!):
  84.  
  85. >> Recase C:#? LIBS:#? UPPER
  86. >> dir LIBS:
  87.    AMIGAGUIDE.LIBRARY              ASL.LIBRARY
  88.    BGUI.LIBRARY                    BULLET.LIBRARY
  89.    COMMODITIES.LIBRARY             DATATYPES.LIBRARY
  90.  
  91. ----------------------------------------------------------------------------
  92.  
  93. Details:
  94.  
  95. The CTRL-C or CTRL-E signals can be used to stop the program at any time.
  96.  
  97. AmigaDOS standard patterns are accepted, and a standard template can be
  98. displayed.  The program is 100% compliant with recommended program guidelines
  99. and will run under any Os from 2.0 to 3.1 and beyond.
  100.  
  101. It is not possible to recase the contents of a directory by simply specifying
  102. the directory name; this is not something I overlooked.  This is because you
  103. may recase a directory name.  If you want to recase the contents of an entire
  104. directory, use "DirName/#?".  This will not be recursive.  If you use Recase
  105. with a directory utility like Opus, you can configure it to be recursive.
  106.  
  107. When recasing large directories to upper or lowercase (by specifying a pattern),
  108. you will notice that Recase caches the all the filenames for a pattern first,
  109. without displying anything, and then changes all the names.  This is not faster,
  110. actually, it is slower.  However, it is necessary, because if Recase attempts
  111. to rename the files in one pass (as it is going through the directories), the
  112. pattern matching may pick up the renamed filename as a new file, and can get
  113. stuck in a loop.  By caching all the names before any modifications are made,
  114. Recase can avoid this problem.
  115.  
  116. ----------------------------------------------------------------------------
  117.  
  118. Liability/Warranty:
  119.  
  120. This program has a money-back guarantee.  It should never cause any problems
  121. for you, since it can only rename files with a new case.  It cannot move or
  122. delete files, give them a different name, or write to your hard drive.
  123. However, if it ever ticks you off, send me a note, and I'll send back all
  124. the money you paid me...  ;-)
  125.  
  126. ----------------------------------------------------------------------------
  127.  
  128. Author:
  129.  
  130. I, Ian J. Einman, hereby claim this program and all of the rocks that may be
  131. hurled at me for writing it.
  132.  
  133. Send bug reports and criticisms to:
  134.  
  135. Mortimer Snerd
  136. 1 Micro Way
  137. Redmond, WA 98101 USA
  138.  
  139. Send money, postcards, good suggestions, and pictures of your sister to:
  140.  
  141. Ian J. Einman
  142. P.O. Box 5711
  143. Bellingham, WA 98227 USA
  144.  
  145. ----------------------------------------------------------------------------
  146.  
  147. Copyright:
  148.  
  149. ©1996 Ian J. Einman
  150.  
  151. I don't make a habit of releasing copyright-free software...  this software
  152. is NOT Public Domain, it is Freeware.
  153.  
  154. Therefore, you may distribute this program anywhere you like, as long as
  155. it includes this "readme" file.
  156.  
  157. You may not legally modify or add to this archive any any way, EXCEPT for
  158. translations of the "readme" file to other languages.  You may only remove
  159. the English "readme" file if the translation to the other language is
  160. COMPLETE.  I would appreciate copies of any translations, but do not require
  161. them.
  162.  
  163. If you include this file on a magazine coverdisk, I would like a copy please.
  164.